home *** CD-ROM | disk | FTP | other *** search
/ Space & Astronomy / Space and Astronomy (October 1993).iso / mac / programs / satrack / OEU.ZIP / DOCUMENT.DOC < prev    next >
Text File  |  1992-11-20  |  18KB  |  390 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                             ORBITAL ELEMENT UTILITIES
  9.                                BY LAWRENCE BALDWIN
  10.                                 NOVEMBER 20, 1992
  11.  
  12. ORBITAL ELEMENTS UTILITIES (OEU) is used to create, update, check and perform
  13. various functions with orbital elements and orbital element files.  I do not
  14. guarantee that somewhere along the line the user will not run into some type of
  15. trouble.  I recommend that all files have a backup made before using OEU on
  16. them.  I have included a file called ELEMENTS.TXT for you to practice on before
  17. you begin to use OEU on your own elements.  If you do have any problems,
  18. comments or suggestions, please write me so I can make changes to improve OEU.
  19.  
  20. Lawrence Baldwin
  21. 9303 Fiesta Way
  22. Louisville, Ky.  40272
  23.  
  24.  
  25.  
  26. WHAT ARE ORBITAL ELEMENTS?
  27. --------------------------
  28.  
  29. Orbital Elements are issued by many sources to be used with
  30. satellite tracking programs.  These are two lines that contain
  31. data such as Epoch, Decay Rate, Inclination, etc. about a
  32. satellite.
  33.  
  34. Orbital elements look like the example below that was for the
  35. Russian Mir Space Station.
  36.  
  37. 1 16609U 86 17  A 92156.77600283 0.00007728  00000-0  77143-4 0  7802
  38. 2 16609  51.6000 308.9681 0023779 131.7850 228.5533 15.56653988360344
  39.  
  40.  
  41. OEU does require each set of orbital elements to have a satellite
  42. name attached to them in this format below (also review file
  43. ELEMENTS.TXT).
  44.  
  45. MIR
  46. 1 16609U 86 17  A 92156.77600283 0.00007728  00000-0  77143-4 0  7802
  47. 2 16609  51.6000 308.9681 0023779 131.7859 228.5533 15.56653988360344
  48.  
  49.  
  50. If yours does not have a name in this format you will need to add
  51. a name for each satellite by using an editor or word processor.
  52.  
  53. Most satellite tracking programs do not require NDDOT 6, Bstar, or
  54. Ephemeris Type numbers (spaces 45-63 in elements line one) to
  55. make them function.  Due to this and to allow space for other
  56. data, none of the utilities in OEU will use these numbers.  If you
  57. do need to use this data, again you will have to add the NDDOT 6, Bstar
  58. and Ephemeris data by using an editor or a word processor.
  59.  
  60.  
  61. WHERE TO RECEIVE ORBITAL ELEMENTS
  62. ---------------------------------
  63.  
  64. Orbital elements can be received from many sources.  Many can be received over
  65. various Bulletin Board Systems.  Here is a small list of BBS's that operate 24
  66. hours a day.
  67.  
  68. For orbital elements for shuttle missions that are in progress:
  69.  
  70. Spacelink, operated by the Marshall Space Flight Center in Huntsville, Alabama
  71. 1-205-895-0028
  72.  
  73. Johnson Space Flight Center, Houston, Texas,  1-713-483-2419
  74.  
  75.  
  76.  
  77. For all types of satellites:
  78.  
  79. RPV Bulletin Board System, Rancho Palos Verdes, California, 1-310-541-7299
  80.  
  81. Celestial BBS, Dayton, Ohio  1-513-427-0674
  82.  
  83. Orbital Information Group BBS operated by the Goddard Space Flight Center
  84. 1-301-306-0010, 0011, 0012, and 0013
  85.  
  86.  
  87.  
  88. If you don't have access to a modem for your computer, orbital elements can be
  89. obtained through the mail from the Goddard Space Flight Center.  First you need
  90. to obtain a copy of the Satellite Situation Report that is published quarterly.
  91. This is due to the fact that satellites must be ordered by their catalog number
  92. that is given in the report.  The satellite report can be received by writing:
  93.  
  94.                       Office of Public Affairs (Code 130)
  95.                       NASA Goddard Space Flight Center
  96.                       Greenbelt, Maryland U.S.A.  20771
  97.  
  98. When you have decided what satellite orbital elements you want to receive, send
  99. your list with the satellite's name and catalog number to:
  100.  
  101.                       Project Operations Branch (Code 513)
  102.                       NASA Goddard Space Flight Center
  103.                       Greenbelt, Maryland U.S.A.  20771
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.                 ********************************
  111.                 ** ORBITAL ELEMENTS UTILITIES **
  112.                 ********************************
  113.  
  114.   NOTE:  ALL FILES THAT ARE ACCESSED BY OEU MUST RESIDE IN A DIRECTORY.
  115.  
  116.  
  117.  
  118.                    ORBITAL ELEMENTS MENU
  119.                    ---------------------
  120.  
  121. The ORBITAL ELEMENTS MENU (filename UTILMENU.EXE) only serves one purpose, and
  122. that is to tie all the programs together.  Each program can be executed
  123. separately but, when you exit that program it will return to the ORBITAL
  124. ELEMENTS MENU.
  125.  
  126.  
  127.                     ORBITAL ELEMENTS EDITOR
  128.                     -----------------------
  129.  
  130. The EDITOR is used to update existing files and create new files. The EDITOR
  131. will first display a screen asking for the directory, file name, and disk drive
  132. that the file you want to edit resides in. If this file is not found when
  133. exiting EDITOR, this file will be created.
  134.  
  135. NOTE:  EDITOR WILL ONLY HOLD 200 SATELLITES IN A FILE.  IF MORE THAN 200 RESIDE
  136.        IN A FILE, YOU WILL NEED TO USE 'CONVERTER' TO BREAK THE FILE DOWN.
  137.  
  138.  
  139. Once the above information is entered, EDITOR will display its main menu.
  140. There are five functions on this screen: 1. ADD NEW SATELLITE, 2. UPDATE A
  141. SATELLITE, 3. DELETE A SATELLITE, 4. CREATE MULTIPLE FILE DUMP, <ESC> EXIT
  142. SYSTEM.  Let's look at each function separately.
  143.  
  144.  
  145.                         1. ADD A SATELLITE
  146.                         ------------------
  147.  
  148. When you press <1> from the EDITOR's main menu, you will be taken to where new
  149. satellites that don't exist in a file are added.  Notice at the top of the
  150. screen that an example set of orbital elements is displayed.  This display will
  151. show you, as you enter your orbital elements where the information is located
  152. if you are reading your elements from a printed list.  As you go down the list
  153. on the screen to enter your data, two arrows will show you where this data
  154. starts and stops in the element line.  There will not be any arrows displayed
  155. when the satellite's name is asked for.
  156.  
  157. Once all data is added, you will be asked if you want to add another satellite
  158. or not.  Make your choice with a 'Y' for yes and an 'N' for no.   If 'N' is
  159. entered, then the user will be taken back to the main menu.
  160.  
  161.  
  162.                         2. UPDATE A SATELLITE
  163.                         ---------------------
  164.  
  165. When <2> is pressed from the main menu, the user will be taken to the area
  166. where elements for satellites are updated.  The first screen will display all
  167. the satellites that are in your file with 15 satellites to a screen.  If there
  168. are more than 15 satellites in your file just press any key to scroll through
  169. the list or press <ESC> to interrupt the scroll.
  170.  
  171. Notice on the left of the screen that there will be a number next to the
  172. satellites' names.  This number is used to pick the satellite that you want to
  173. update.  Let's say you want to update the Hubble Space Telescope and the number
  174. on the left of it is 24.  When you have reached the end of your file, you will
  175. be able to enter this number to bring up the elements for Hubble.
  176.  
  177. When the elements screen is displayed, you will notice the elements display at
  178. the top of the screen (See 1. ADD A NEW SATELLITE above for description) and
  179. all the orbital elements for your selected satellite.  You can pick separately
  180. each element that you want to update by entering its number at the prompt at
  181. the bottom of the screen.  Let's say you want to change the epoch date.  This
  182. is done by entering the number 7 at the bottom of the screen where it will ask
  183. you  next to enter that data.  When <ENTER> is pressed the update screen will
  184. be updated.
  185.  
  186. On updating the satellites name by entering <1>, you have a option to do two
  187. things, 1. update the satellite's name or 2. enter an asterisk (*).  If an
  188. asterisk is entered, the name is not updated but the asterisk is attached to
  189. the end of the satellite's name.  This is to indicate that the satellite has
  190. re-entered the earth's atmosphere.  When you leave the element screen by 
  191. pressing <ENTER> with no entry at the prompt, you will be taken back to the
  192. selection screen for another selection.  If you entered an asterisk on any 
  193. satellite, on the right side of the screen, that satellite will display
  194. 'RE-ENTERED EARTH'S ATMOSPHERE.'
  195.  
  196. If you decide not to select another satellite and to return to the main menu,
  197. just press <ENTER> with no entry at the prompt when you reach the end of the
  198. list.
  199.  
  200.                      3. DELETE A SATELLITE
  201.                      ---------------------
  202.  
  203. When <3> is pressed from the main menu the user is taken to the area where
  204. satellites are deleted from the file.  There will be a flashing 'DELETING FILE'
  205. message at the top to let you know that you have entered this area of the
  206. program.  To delete the satellite that you want enter the number to the left of
  207. the satellite's name when prompted.  If for some reason you have entered this
  208. area by mistake and do not want to delete any satellites just press <ENTER> by
  209. itself at the prompt, and you will return to the main menu screen without any
  210. satellites being deleted.  After each satellite is deleted from the file the
  211. user will be taken back to the main menu.
  212.  
  213.                        4. CREATE MULTIPLE FILE DUMP
  214.                        ----------------------------
  215.  
  216. Most people that track satellites will use the same elements in more than one
  217. tracking program.  The MULTIPLE FILE DUMP option is to let a user that has
  218. updated an element file from one program, copy it to other programs as well. 
  219. For example, let's say that you have updated a file in program STSORBIT and
  220. when you save the file, you would also like for it to go to STSPLUS and to PC-
  221. Track.  This is what MULTIPLE FILE DUMP is all about.  You will be able to save
  222. one file update to as many as 15 other programs.  The key thing you need to
  223. know is where each program that the file will be saved to is located in your
  224. system (directory, program name and disk drive).
  225.  
  226. When you press <4> from the main menu, a display screen of all 15 paths is
  227. displayed.  Notice in the first path that the file that you originally enter at
  228. the very first screen to update or create a file is listed there.  This is so
  229. it will be updated or created when you exit EDITOR.
  230.  
  231. To add a path that sends your file to a certain program, you must know the
  232. directory, file name and disk drive that the program resides in.  Let's say
  233. that we want to save our file to the program, STSPLUS, that resides in
  234. directory, SPACE, of disk drive 'C', and we want that file to be called
  235. ELEMENTS.TXT.  You will enter at the PATH prompt at the bottom of the screen:
  236.  
  237.                         C:\SPACE\ELEMENTS.TXT
  238.  
  239. When <ENTER> is pressed, the path name will be entered in the next available
  240. path slot.
  241.  
  242. If you would like your file saved to a path with the same name as the file that
  243. you loaded into EDITOR, enter as the file name '*.*'.   For example; we loaded
  244. in a file named ELEMENTS.TXT and would like that same name added to the program
  245. STSPLUS when it is saved.  Your path entry will look like this:
  246.  
  247.                     C:\SPACE\*.*
  248.  
  249. To delete a path, just enter the path number in the PATH prompt at the bottom
  250. of the screen.  When enter is pressed, that path will be deleted and all
  251. remaining paths will move up one slot.
  252.  
  253. To exit from MULTIPLE FILE DUMP, just press <ENTER> without entering anything
  254. in the PATH prompt.  All your paths that you have entered into EDITOR will then
  255. be saved to a file called PGMSTORE.TXT.  Each time that a file is saved, EDITOR
  256. will read PGMSTORE.TXT, and save all files to these programs until PGMSTORE.TXT
  257. is updated once again.
  258.  
  259.                        <ESC>  EXIT SYSTEM
  260.                        ------------------
  261.  
  262. Press <ESC>, and EDITOR will begin creating your orbital elements and then will
  263. return to ORBITAL ELEMENT UTILITIES MENU.  During the creation of the orbital
  264. elements, it will save your file to all programs that were specified in the
  265. MULTIPLE FILE DUMP.  It will also calculate new check sum numbers for each line.
  266. Since we did not use NDDOT 6, Bstar and Ephemeris data, the check sum numbers
  267. would have changed.  If EDITOR did not update these numbers your file could
  268. cause some programs to crash when used.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.                            ORBITAL ELEMENT CHECKER
  275.                            -----------------------
  276.  
  277.  
  278. CHECKER is used to check orbital elements for the most common errors that may
  279. exist.  This could be bad check sum numbers, lines longer or shorter than 69
  280. characters, digits where spaces should be and decimal points out of place.  If
  281. you down loaded your elements from a Bulletin Board System its recommended that
  282. you use CHECKER.  NASA has been known to send out elements with bad formats.
  283.  
  284. Since you may not run across any errors in any orbital elements for sometime
  285. (maybe never), I have encluded a file call WRONG.TXT that you can check to see
  286. how CHECKER works.
  287.  
  288. By pressing <2> from the ORBITAL ELEMENT MENU the user is taken to ORBITAL
  289. ELEMENT CHECKER.  CHECKER consists of only one screen.  You will be asked to
  290. enter the directory, file name and disk drive of where the file that you wish
  291. to check resides.
  292.  
  293. Next, you will be asked if you want a detailed print out.  If this option is
  294. answered as 'Y' (yes), make sure that your printer is turned on.  This will
  295. print out a detailed description of what is wrong with your orbital elements if
  296. anything.
  297.  
  298. When <ENTER> is pressed, CHECKER will begin checking your file.  It will
  299. display each satellite as it is checking it.  For a file with about 700 or more
  300. satellites in it, it may take a minute or two depending on the speed of your
  301. system.  When CHECKER is finished checking your file, it will display a small
  302. summary of what was wrong.  It will show you how many satellites were checked,
  303. the number of check sums that were updated, how many elements that were not 69
  304. characters long, how many spaces in a line had digits in them, and how many
  305. decimal points were out of alignment.
  306.  
  307. CHECKER will only update the check sum numbers if it is wrong.  Other errors
  308. that may be found are not updated.  This is so the user can determine which
  309. data is good and which is not, and make the necessary changes.
  310.  
  311. If the user wishes to do another check of a file, they should press <ENTER>.
  312. All prompts will default to the previous settings except for the detail print
  313. out.
  314.  
  315. To exit checker press <ESC>.
  316.  
  317. If for some reason that you would like to have your original file back, CHECKER
  318. has renamed it as OLDCHECK.TXT and you will find it in the directory of the
  319. file that you were checking.
  320.  
  321.  
  322.                      ORBITAL ELEMENT SELECTOR
  323.                      ------------------------
  324.  
  325. If a user has a large file and would like a few of the satellites in it in a
  326. file by themselves then SELECTOR will do the job easily.  For example you have
  327. a file with over 700 satellites in it and you would like Mir, Hubble Space
  328. Telescope and the Gamma Ray Observatory by themselves in one file.
  329.  
  330. Press <3> from the ORBITAL ELEMENTS UTILITIES MENU, and the user will be
  331. brought to SELECTOR.  The user will be asked for the directory, file name and
  332. disk drive in which the main file is located.  Next, give a name for the file
  333. that you will be putting your satellites into.  The main list of satellites
  334. will begin to scroll.  Notice on the left that each satellite has a number. 
  335. When selecting the satellite that you want, enter this number into the prompt
  336. at the bottom of the screen, and it will add it to your new file.   To continue
  337. scrolling through the file, just press <ENTER>.  To end the scrolling at
  338. anytime, just type 'END' into the prompt and you will be given two options, 1.
  339. restart SELECTOR or 2. exit SELECTOR.  Press <ENTER> to restart SELECTOR and
  340. press <ESC> to exit and return to ORBITAL ELEMENTS MENU.
  341.  
  342.  
  343.  
  344.                    ORBITAL ELEMENTS CONVERTER
  345.                    --------------------------
  346.  
  347. CONVERTER will break down large files into smaller files.  EDITOR will only
  348. hold 200 satellites at one time, so a file that is larger than 200 needs to be
  349. broken down.
  350.  
  351. CONVERTER will first ask for the directory, file name and disk drive that the
  352. file that needs to be broken down resides in.  Next, the user will need to give
  353. the broken down files a name.  Then CONVERTER will ask for the number of
  354. satellites that you would like in each file.  When this number is reached,
  355. CONVERTER will begin building a new file.  It will use the name that you
  356. entered but will change the file extension to 001 , 002 and so on. CONVERTER
  357. will next ask for the minimum and the maximum of the inclination of the
  358. satellites.  This is for building a file of satellites that falls within a
  359. certain range.
  360.  
  361. Once this information is entered, CONVERTER will begin to break down the files
  362. into smaller ones with the number of satellites and inclination ranges that you
  363. specified.
  364.  
  365. When CONVERTER is finished, just press <ENTER> to return to ORBITAL ELEMENTS
  366. MENU.
  367.  
  368.  
  369.  
  370.  
  371.                       ORBITAL ELEMENT FINDER
  372.                       ----------------------
  373. FINDER is used to find a certain satellite in a large file and view its
  374. elements.  Finder will first ask you for the directory, file name and disk
  375. drive in which the file that you are searching for resides in.  You will next
  376. enter the satellites' name or its catalog number.  When entering the name, you
  377. can enter it in either upper or lower case letters.  If you would like to view
  378. all satellites that have the first few characters in common, enter those
  379. characters only.  If a satellite is found, it will be displayed.  Press <ENTER>
  380. to begin the search process again.  Press <SPACE BAR> to continue the current
  381. search or <ESC> to end FINDER and return to ORBITAL ELEMENTS MENU.
  382.  
  383.  
  384.                        ORBITAL ELEMENTS VIEWER
  385.                        -----------------------
  386.  
  387. VIEWER will display an entire element file.  Just enter directory, file name,
  388. and disk drive that the file is in.  You can view the whole file and continue
  389. from page to page by pressing any key, and stop at anytime by pressing <ESC>.
  390.